home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / languages / dde / _pc / h / dboxfile < prev    next >
Text File  |  1992-02-09  |  2KB  |  50 lines
  1. (* 
  2.  * Title:   dboxfile.h
  3.  * Purpose: display of a dialogue box, for file name input.
  4.  *
  5.  *)
  6.  
  7. #ifndef __dboxfile_h
  8. #define __dboxfile_h
  9.  
  10. (* ------------------------------ dboxfile ---------------------------------
  11.  * Description:   Displays dialogue box with message, input field, and 
  12.  *                OK field and allows input of filename.
  13.  *
  14.  * Parameters:    char *message -- informative message to be displayed
  15.  *                                 in dialogue box
  16.  *                unsigned filetype -- OS-dependent type of file
  17.  *                char *a -- default filename (initially) and also used
  18.  *                           for user-typed filename
  19.  *                int bufsiz -- size of "a"
  20.  * Returns:       void.
  21.  * Other Info:    The template for the dialogue box must be called
  22.  *                "dboxfile_db".  Parameters correspond to the template's
  23.  *                icon numbers as follows:
  24.  *                     icon #0 -- OK button
  25.  *                     icon #1 -- message
  26.  *                     icon #2 -- filename
  27.  *                Template should have the following icons:
  28.  *                     icon #0 -- a text icon containing text "OK"
  29.  *                                with button type "menu icon"
  30.  *                     icon #1 -- an indirected text icon (possibly with
  31.  *                                a default message) with button type
  32.  *                                "never"
  33.  *                     icon #2 -- an indirected text icon with button
  34.  *                                type "writeable".
  35.  *                See the "dboxfile_db" template used by !Edit for an
  36.  *                example.
  37.  *                Message must be of max length 20
  38.  *                The char array pointed to by "a" will contain the typed-in
  39.  *                file name of max length bufsize (if longer, truncated)
  40.  *
  41.  *)
  42. procedure dboxfile(message : string;
  43.                 filetype : integer;
  44.                 a : string;
  45.                 buffsize : integer); extern;  
  46.  
  47. #endif
  48.  
  49. (* end of dboxfile.h *)
  50.